# Troubleshooting

To add new solutions, please open a pull request, issue or contact me directly.

Sorted by appearance from installation (top) to gameplay (bottom).


#### Game download issues

Download timeout, stuck at 0%:

 * Sep/Oct 2020 launcher bug. Download the newest version and retry

Download works but launcher freezes/crashes midway:

 * See [Issue#28](https://notabug.org/Krock/GI-on-Linux/issues/28) for solutions


#### Game does not start at all

1. Check & update the game version in your launcher
2. Apply the correct modifications


#### StartThreadpoolIo not found in KERNEL32.dll

 * Use Wine 5.3 or newer. This function has been added recently.
 * For more details, see [Issue#12](https://notabug.org/Krock/GI-on-Linux/issues/12#issuecomment-22060).


#### White screen freeze when entering the door
... plus error log "*err:virtual:virtual_setup_exception stack overflow*".

Seen after 24 Dec (except on 29/30 Dec). This error is caused by server-sent bytecode. Workaround:

	bash "/path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh"

For more details, see [Issue#23](https://notabug.org/Krock/GI-on-Linux/issues/23).


#### Crash when initially loading the world (7 symbols)

Rare occurrence related to an audio failure. Observed in Wine 5.22 and newer.

1. Restart the game
2. Check for music and button sound effects


#### ZFGameBrowser crash

 * Ignore and restore the game window
 * For input issues: try the virtual desktop (see below)

For more details, see [Issue#29](https://notabug.org/Krock/GI-on-Linux/issues/29).


#### Graphics bugs/issues

 * Check whether your GPU supports Vulkan:
     * [unofficial list](https://vulkan.gpuinfo.org/), [Intel](https://www.intel.com/content/www/us/en/support/articles/000005524/graphics.html), [nVIDIA](https://developer.nvidia.com/vulkan-driver), [AMD](https://www.amd.com/en/technologies/vulkan#paragraph-218601)
     * If yes -> download [winetricks](https://github.com/Winetricks/winetricks/)
     * `bash winetricks`
     * Install the DLL package `dxvk` (newest stable version)
 * Try Proton: add `launcher.bat` to your game library.


#### Mouse/keyboard input issues

Easiest solution:

 * `wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat` (adjust to your resolution)

Lutris:

 * Runner options -> Enable virtual desktop

Without a virtual desktop: (experimental)

 * winecfg -> capture mouse in full screen
 * regedit -> `HKEY_CURRENT_USER\Software\Wine\X11 Driver` set REG_SZ `UseTakeFocus` to `N`
      * Lutris already does this by default.


#### Switching between workspaces causes the view to "spin"

Change the in-game resolution setting:

1. Focus the (virtual) desktop
2. Focus the game window again
3. Change the resolution back to fullscreen


#### Weak graphics, slow game

Please keep in mind that the minimal specifications also apply for Linux. Do not expect a performance gain compared to Windows native.

1. Change the detail level to `1.0` other values may be slower
2. Lower the resolution. Edit `launcher.bat` and append following arguments:
     * `-screen-width XXX -screen-height YYY -screen-fullscreen 1`
     * or change the virtual desktop's size (if present)
3. See also: [Unity CLI args](https://docs.unity3d.com/Manual/CommandLineArguments.html)
     * `-screen-quality` is only applied to the first login scene, hence useless


### Information sources

General information:

 * [PlayOnLinux](https://www.playonlinux.com/en/app-4228.html)
